home *** CD-ROM | disk | FTP | other *** search
/ Power Utilities / Power Utilities.iso / ek / acd210 / patch.doc < prev    next >
Encoding:
Text File  |  1992-07-31  |  11.3 KB  |  373 lines
  1. ┌──────────────────────────────────────────────────────────────────────────┐
  2. │Documentation of allowed patches in ACD version 2.10, dated Aug. 1, 1992  │
  3. └──────────────────────────────────────────────────────────────────────────┘
  4.  
  5.    Some people hate to lose precious environment space, and that's why you are
  6.    allowed to patch ACD.EXE with your preferred default values. The easiest
  7.    way to to do so is to use the ACD_CFG program included with ACD. The *.P22
  8.    files will probably not be updated in next releases, whereas ACD_CFG will
  9.    always represent ALL 'current' configuration possibilities.
  10.  
  11.    So, the environment variables "ACD_COLOR" and "ACD" are then almost
  12.    obsolete. Below is a list of patches you are allowed to make.
  13.    However, you are NOT allowed to redistribute a patched version, but
  14.    only the original version, with the complete documentation.
  15.  
  16.    The easiest way to make the patches is to use PATCH22 from Jurgen A.
  17.    Doornik (current version: P22V12.zip), which can also be obtained from the
  18.    SIMTEL20 archives, and is also free of charge.
  19.    
  20.    patch nr.│ file         │ description
  21.    ─────────┼──────────────┼──────────────────────────────────────────────
  22.        1    │ acd_col .p22 │ default colours (ACD_COLOR)
  23.        2    │ acd_par0.p22 │ functionality of ACD without parameters (/0)
  24.        3    │ acd_hist.p22 │ scrollback history size
  25.        4    │ acd_know.p22 │ unknown directory -> update acd.idx (/u)
  26.        5    │ acd_drv .p22 │ test inactive drives (/i)
  27.        6    │ acd_graf.p22 │ graphical display (/g)
  28.        7    │ acd_lite.p22 │ highlight selection line (/l)
  29.        8    │ acd_cur .p22 │ current drive selection (/c)
  30.        9    │ acd_menu.p22 │ menu choices (/m)
  31.       10    │ acd_win .p22 │ maximum size of pop-up window
  32.       11    │ acd_exct.p22 │ exact match (/e)
  33.       12    │ acd_srnk.p22 │ shrink searchstring (/s)
  34.       13    │ acd_exec.p22 │ Execute program with ALT-E from pop-up window
  35.  
  36.  
  37. PATCH 1: default colours (ACD_COLOR)
  38.  
  39.    Instead of setting the default colors by the environment variable
  40.    ACD_COLOR, you can apply the patch below to change the colors ACD uses.
  41.    By using the following table:
  42.  
  43.           Dark Colors         ║
  44.          (Foreground &        ║  Light Colors
  45.          Background) Dec Hex  ║  (Foreground)  Dec Hex
  46.         ═══════════╤══════════╬══════════════╤════════
  47.          Black     │ 0  (00)  ║ DarkGray     │  8 (08)
  48.          Blue      │ 1  (01)  ║ LightBlue    │  9 (09)
  49.          Green     │ 2  (02)  ║ LightGreen   │ 10 (0A)
  50.          Cyan      │ 3  (03)  ║ LightCyan    │ 11 (0B)
  51.          Red       │ 4  (04)  ║ LightRed     │ 12 (0C)
  52.          Magenta   │ 5  (05)  ║ LightMagenta │ 13 (0D)
  53.          Brown     │ 6  (06)  ║ Yellow       │ 14 (0E)
  54.          LightGray │ 7  (07)  ║ White        │ 15 (0F)
  55.  
  56.    the command
  57.  
  58.        patch22 acd.exe ?\h2A2E2A?\h2A2E2A....?
  59.  
  60.    will patch the default colors of ACD in the colors you prefer: the four
  61.    dots must be replaced by the HEX values of the BackGround Color and
  62.    ForeGround Color. For example:
  63.  
  64.        patch22 acd.exe ?\h2A2E2A?\h2A2E2A010E?
  65.  
  66.    would give you by default yellow characters on blue background, without
  67.    using any environment space.
  68.    You can also modify ACD_COL.P22 to suit your needs and call:
  69.  
  70.        patch22 @acd_col.p22
  71.  
  72.    Of course, you can use Norton utilities, or PCTOOLS as well to change the
  73.    colors. The searchstring to be used is HEX 2A 2E 2A. The two bytes to be
  74.    changed are positioned after this searchstring (00 07).
  75.  
  76.  
  77. PATCH 2: functionality of ACD without parameters (/0)
  78.  
  79.    By default, ACD without parameters acts just as CD without parameters: show
  80.    current directory name. This patch changes the functionality of ACD without
  81.    parameters:
  82.  
  83.         patch22 acd.exe +5?\h2A2E2A?*?
  84.  
  85.    which changes the third byte after the searchstring (hex 20).
  86.    Now ACD without parameters is equivalent to ACD *, just like NCD.
  87.  
  88.    Another patch to change the function of ACD without parameters is:
  89.  
  90.         patch22 acd.exe +5?\h2A2E2A?=?
  91.  
  92.    which, again, changes the third byte after the searchstring (hex 20). Now
  93.    ACD without parameters is equivalent to ACD =, so by default the scrollback
  94.    history will be used.
  95.  
  96.    You can also modify ACD_PAR0.P22 to suit your needs and call:
  97.  
  98.         patch22 @acd_par0.p22
  99.  
  100.  
  101. PATCH 3: scrollback history size
  102.  
  103.    The command
  104.  
  105.         patch22 acd.exe +6?\h2A2E2A?\h00?
  106.  
  107.    changes the size of the scrollback history in a historysize of 0.
  108.    The command
  109.  
  110.         patch22 acd.exe +6?\h2A2E2A?\h20?
  111.  
  112.    restores the patch in the original ACD historysize of 20.
  113.    You can also modify ACD_hist.P22 to suit your needs and call:
  114.  
  115.         patch22 @acd_hist.p22
  116.  
  117.  
  118.  PATCH 4: unknown directory -> update acd.idx (/u)
  119.  
  120.    The command
  121.  
  122.         patch22 acd.exe +7?\h2A2E2A?\h00?
  123.  
  124.    ensures that ACD.IDX database will not be updated when ACD encounters an
  125.    unknown sub-directory with a known parent. See also the /u option.
  126.  
  127.    The command
  128.  
  129.         patch22 acd.exe +7?\h2A2E2A?\h02?
  130.  
  131.    ensures that ACD.IDX database will be updated when ACD encounters an
  132.    unknown sub-directory with a known parent, and also ALL subdirectories will
  133.    be added.
  134.  
  135.    For the values \h03 and \h04: see /u option.
  136.  
  137.    The command
  138.  
  139.         patch22 acd.exe +7?\h2A2E2A?\h01?
  140.  
  141.    restores the patch in the original ACD defaultvalue.
  142.    You can also modify ACD_know.P22 to suit your needs and call:
  143.  
  144.         patch22 @acd_know.p22
  145.  
  146.  
  147. PATCH 5: test inactive drives (/i)
  148.  
  149.    The command
  150.  
  151.         patch22 acd.exe +8?\h2A2E2A?\h01?
  152.  
  153.    ensures that by default the drives will not be tested for their existence:
  154.    all information will be displayed. The /i option will then get the opposite
  155.    meaning.
  156.  
  157.    The command
  158.  
  159.         patch22 acd.exe +8?\h2A2E2A?\h00?
  160.  
  161.    restores the patch in the original ACD defaultvalue.
  162.    You can also modify ACD_drv.P22 to suit your needs and call:
  163.  
  164.        patch22 @acd_drv.p22
  165.  
  166.  
  167. PATCH 6: graphical display (/g)
  168.  
  169.   The command
  170.  
  171.         patch22 acd.exe +9?\h2A2E2A?\h00?
  172.  
  173.   will make the non-graphical display as default. The /g option will then get
  174.   the opposite meaning.
  175.   The command
  176.  
  177.         patch22 acd.exe +9?\h2A2E2A?\h01?
  178.  
  179.   restores the patch in the original ACD defaultvalue.
  180.   You can also modify ACD_graf.P22 to suit your needs and call:
  181.  
  182.         patch22 @acd_graf.p22
  183.  
  184.  
  185. PATCH 7: highlight selection line (/l)
  186.  
  187.    The command
  188.  
  189.         patch22 acd.exe +10?\h2A2E2A?\h00?
  190.  
  191.    will make the highlight only affect the last subdirectory in the pop-up
  192.    window instead of the complete line. The /l option will then get the
  193.    opposite meaning.
  194.    The command
  195.  
  196.         patch22 acd.exe +10?\h2A2E2A?\h01?
  197.  
  198.    restores the patch in the original ACD defaultvalue.
  199.    You can also modify ACD_lite.P22 to suit your needs and call:
  200.  
  201.         patch22 @acd_lite.p22
  202.  
  203.  
  204. PATCH 8: current drive selection (/c)
  205.  
  206.    The command
  207.  
  208.         patch22 acd.exe +11?\h2A2E2A?\h01?
  209.  
  210.    will make the /c option default: use the information on the current drive
  211.    only. The /c option used from the commandline will then get the opposite
  212.    meaning.
  213.    The command
  214.  
  215.         patch22 acd.exe +11?\h2A2E2A?\h00?
  216.  
  217.    restores the patch in the original ACD defaultvalue.
  218.    You can also modify ACD_lite.P22 to suit your needs and call:
  219.  
  220.        patch22 @acd_cur.p22
  221.  
  222.  
  223. PATCH  9: menu choices (/m)
  224.  
  225.    The command
  226.  
  227.         patch22 acd.exe +12?\h2A2E2A?\h00?
  228.  
  229.    will put the menu choices OFF by default. The /m option used from the
  230.    commandline will then get the opposite meaning.
  231.    The command
  232.  
  233.         patch22 acd.exe +12?\h2A2E2A?\h01?
  234.  
  235.    restores the patch in the original ACD defaultvalue.
  236.    You can also modify ACD_menu.P22 to suit your needs and call:
  237.  
  238.         patch22 @acd_menu.p22
  239.  
  240.  
  241. PATCH 10: maximum size of pop-up window
  242.  
  243.    The command
  244.  
  245.         patch22 acd.exe +13\h2A2E2A?\h10?
  246.  
  247.    changes the maximum size of the pop-up window in 16 (Hex 10).
  248.    The command
  249.  
  250.         patch22 acd.exe +13?\h2A2E2A?\hFF?
  251.  
  252.    which changes the eleventh byte after the searchstring in hex FF (the
  253.    original ACD default value), which will yield a pop-up window based on the
  254.    number of lines of your screen: a 43 line videomode, for example, would
  255.    allow for a 38 line window. In general: the maximum number of lines
  256.    (directory entries) in the window is equal to
  257.  
  258.      min(lines in mode-5, patched maximumsize)
  259.  
  260.    You can also modify ACD_win.P22 to suit your needs and call:
  261.  
  262.        patch22 @acd_win.p22
  263.  
  264.  
  265. PATCH 11: exact match (/e)
  266.  
  267.    The command
  268.  
  269.        patch22 acd.exe +14?\h2A2E2A?\h01?
  270.  
  271.    will let ACD switch to a directory if exactly one directory name is found
  272.    in the ACD database with this exact name. The /e option will get the
  273.    opposite meaning.
  274.    The command
  275.  
  276.        patch22 acd.exe +14?\h2A2E2A?\h00?
  277.  
  278.    will restore the original ACD default value.
  279.    You can also modify ACD_exct.P22 to suit your needs and call:
  280.  
  281.        patch22 @acd_exct.p22
  282.  
  283.  
  284. PATCH 12: shrink searchstring (/s)
  285.  
  286.    The command
  287.  
  288.        patch22 acd.exe +16?\h2A2E2A?\h00?
  289.  
  290.    will stop ACD from trying to guess what is meant if no match is found. The
  291.    /s option will get the opposite meaning.
  292.  
  293.    The command
  294.  
  295.        patch22 acd.exe +16?\h2A2E2A?\h01?
  296.  
  297.    will restore the original ACD default value.
  298.    You can also modify ACD_srnk.P22 to suit your needs and call:
  299.  
  300.        patch22 @acd_srnk.p22
  301.  
  302.  
  303. PATCH 13: execute program with ALT-E
  304.  
  305.    Below follow some examples for letting ALT-E execute a program or command
  306.    from the ACD popup-window. The highlighted directoryname can be included in
  307.    the parameters, by specifying %dir% in the "parameterpatch".
  308.  
  309.    Example 1:
  310.  
  311.    If you want to delete all files in the highlighted directory:
  312.  
  313.    Call command.com ....
  314.  
  315.        patch22 acd.exe -49?\h2A2E2A?command.com ?
  316.                                     123456789012
  317.                     (at most 12 characters for a valid DOS name)
  318.  
  319.    If you are using 4DOS, you can use:
  320.  
  321.        patch22 acd.exe -49?\h2A2E2A?4dos.com   ?
  322.                                     123456789012
  323.  
  324.  
  325.    .... and let command.com/4dos.com delete all files in this directory!
  326.  
  327.        patch22 acd.exe -35?\h2A2E2A?/c del %dir%                    ?
  328.                                     12345678901234567890123456789012
  329.                                     (32 characters for options)
  330.  
  331.    So, the complete command is:
  332.  
  333.        COMMAND.COM /C DEL %dir%
  334.  
  335.    or
  336.  
  337.        4DOS.COM    /C DEL %dir%
  338.  
  339.    As said above, %dir% has a special meaning: use currently highlighted
  340.    directory as parameter. E.g. if the highlighted line is currently
  341.    "c:\archives\temp", then ALT-E executes the command
  342.  
  343.        COMMAND.COM /C DEL C:\ARCHIVES\TEMP
  344.  
  345.    which deletes (after confirmation) ALL files from this directory!
  346.  
  347.    Example 2:
  348.  
  349.    To call Directory Freedom (the default value), or 4FILES, you can enter
  350.    either
  351.  
  352.        patch22 acd.exe -49?\h2A2E2A?DF.COM      ?
  353.  
  354.    or
  355.  
  356.        patch22 acd.exe -49?\h2A2E2A?4F.COM      ?
  357.  
  358.    followed by
  359.  
  360.        patch22 acd.exe -35?\h2A2E2A?%dir%                           ?
  361.  
  362.    So, the complete command is:
  363.  
  364.        DF.COM %dir%
  365.  
  366.    or
  367.  
  368.        4F.COM %dir%
  369.  
  370.    It is assumed that the program names (e.g. COMMAND.COM and DF.COM) can
  371.    be found in the PATH statement; otherwise, nothing happens.
  372.  
  373.